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PREFACE 



This instant provides condensed descriptions of 
Modify, the program library maintenance utility. 
Modify is part of the Network Operating System (NOS) 
for CDC® CYBER 170 Series Computer Systems; 
CDC® CYBER 70 Series, Models 71, 72, 73, and 74 
Computer Systems; and CDC® 6000 Series Computer 
Systems. 

This instant is designed for the experienced NOS 
applications or systems programmer who is familiar 
with Modify. It is intended to serve the user as a 
quick reference tool, not as a stand-alone document. 

Modify provides a means of maintaining source decks 
in a conveniently updatable and compressed format. 
For further information, refer to the NOS Modify 
Reference Manual (publication number 60450100). 

This product is intended for use only as described in 
the Modify Reference Manual. Control Data cannot 
be responsible for the proper functioning of unde- 
scribed features or undefined parameters. 
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DIRECTIVE FORMAT 

The format for a Modify directive is as follows: 
*dirname p^, p 2 > . . . . P n 

* Prefix character beginning in 

column 1 (defined by Modify as 
asterisk, changed with PREFIX 
or PREFIXC directives) 

dirname Directive name beginning in column 
2 and followed by a separator 

p. Optional directive parameters 

The directive name and parameters are separated 
by any character with a display code value of 55„ or 
greater, that is, a character other than: 

: A through Z through 9 + -*/■()$ = 



LINE IDENTIFIER 

Modify line identifiers have the following format. 
modname, number 

modname. 1- to 7-character name of a modi- 

Ification set or deck. Legal char- 
acters are A through Z, through 
9, and + -*/()$=. A period 
terminates the modname. 

number Decimal ordinal of the line within 

the modification set or deck. Any 
character other than through 9 
terminates this ordinal. 

The abbreviated form of the line identifier is simply 
the number. 



DIRECTIVE TYPES 



INITIALIZATION 

CREATE 

OPLFILE 
COPY 



Converts decks to program 
library format for modification 

Declares additional program 
library files as input 

Copies one or more records 
from named file to old program 
library 
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COPYPL 



WIDTH 



NOSEQ 



Copies one or more records 
from named file to an internal 
scratch file which is merged 
with program library 

Defines the number of columns 
preceding the sequencing infor- 
mation on the compile file and 
source output file 

Specifies no sequence informa- 
tion on compile file 



MODIFICATION 

IDENT 

IGNORE 

DECK 
MODNAME 

DELETE or D 
RESTORE 
INSERT or I 

YANK 

UNYANK 
PURDECK 



Specifies modname to be 
assigned to new modification 
set 

Ignores modifications for the 
named deck 

Identifies deck to be modified 

Identifies modification set 
within deck to be modified 

Identifies line to be deactivated 

Identifies line to be reactivated 

Identifies lines following as 
insertion lines 

Removes effects of a modifica- 
tion set 

Restores effects of a modifica- 
tion set 

Permanently purges decks 
from program library 



SELECTIVE EDIT 

EDIT 



Names decks for which modifi- 
cation (editing) is to take place 
and written on the compile file, 
source output file, or new 
program library, depending on 
control statement options 
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FILE MANIPULATION 

READ 

READPL 

BKSP 

SKIP 

SKIPR 

REWIND 
RETURN 



Reads record or group of 
records from specified file 

Reads deck or portion of deck 
from program library 

Backspaces specified number 
of records on file 

Skips forward specified number 
of records on file 

Skips forward past the speci- 
fied record on file 

Rewinds named files 

Returns named files to system 



File manipulation is illegal on files defined by 
Modify control statement options. 



COMPILE FILE 
CALL 

IFCALL 

NIFCALL 
CALLALL 



Writes called deck onto com- 
pile file 

Writes called deck onto com- 
pile file if symbol is defined 

Writes called deck onto com- 
pile file if name is not defined 

Writes all decks onto compile 
file that have deckname begin- 
ning with specified character 
string 



| NOTE 1 

A common deck cannot call another com- 
mon deck. If a CALL, IFCALL, NIFCALL, 
or CALLALL directive is in a common 
deck, it is ignored. 
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IF Includes lines in compile file 

if specified attribute is true 
and until a reversal or termi- 
nation directive is encountered 
(ELSE or ENDIF). 

ELSE Reverses an IF directive 

conditional range. 

ENDIF Terminates an IF directive 

conditional range. 
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COMMENT 
WIDTH 

NOSEQ 

SEQ 

WEOR 



Generates COMMENT pseudo 
instruction for COMPASS 

Defines number of columns 
preceding sequence information 
on compile file and source file 

Specifies no sequence informa- 
tion on compile file 

Specifies sequence information 
on compile file 

Writes end of record on com- 
pile file 



CWEOR 



WEOF 



Writes end of record on com- 
pile file if the buffer is not 
empty 

Writes end of file on compile 
file 



SPECIAL 



INWIDTH 



PREFIX 



PREFKC 



DEFINE 



Inserts comment on listing 

Sets width of source text lines 
and insertion text lines. 

Changes prefix character for 
directives other than compile 
file directives 

Changes compile file prefix 
character rather than directives 
file prefix character 

Defines a name and associated 
value under which subsequent 
IFCALL directive may cause 
a common deck to be written 
to the compile file or NIFCALL 
may prevent a common deck 
from being written 
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MOVE Reorders decks on new pro- 

gram library 

UPDATE Specifies editing sequence and 

modification set numbering 

ALPHABETIZED LIST OF DIRECTIVES 

*BKSP file, n Backspaces specified number 

of records on file. If n is 

omitted, one record is back- 
spaced. 

*CALL deckname Writes copy of called common 

deck onto compile file. 

*CALLALL string Writes all decks onto compile 
file that have decknames begin- 
ning with specified character 
string. 



^COMMENT comments 



Generates COMMENT pseudo 
instruction for COMPASS and 
inserts OPL creation date and 
last modification date. 



*COPY file, deckname 



Copies one or more records 
from named file to OPL (P 
parameter) for random access. 
Copying ends with deckname; 
if deckname is omitted or not 
found on file, the remainder of 
the file is copied. Only one 
copy directive is allowed. 
EVICT is performed on OPL 
(P parameter) before copy; copy 
must precede other initializa- 
tion directives if used. 



*COPYPL file, deckname 



Copies one or more records 
from named file to an internal 
scratch file which is merged 
with program library. Copying 
ends with deckname; if deck- 
name is omitted or not found on 
file, the remainder of the file 
is copied. 
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*CREATE file Converts source decks to pro- 

gram library format, initially 
used for creating library, 
adding decks, or replacing 
decks. If a deck duplicates 
one on the program library, the 
new deck takes precedence. 



*CWEOR 



*DECK deckname 



Writes end of record on com- 
pile file if the buffer is not 
empty. 

Identifies deck to be modified; 
precedes modifications to the 
deck. 



*DEFINE name, value 



Defines a 1- to 7-character 
name and a value for use in sub- 
sequent IFCALL, NIFCALL, or 
IF compile-file directives. If 
value is omitted, name is defined 
with value zero; if present, value 
must not exceed 177777„. 



*DELETE c 



Identifies line to be deactivated. 



Identifies first and last lines of 
sequence of lines to be deacti- 
vated; lines to be inserted 
optionally follow. 



*EDIT Pj.P 2 ' 



*ELSE 



*ENDIF 
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Names decks for which modifi- 
cation (editing) is to take place 
and which is written on the com- 
pile file, source output file, or 
new program library, depend- 
ing on control statement options, 
p. can be a single deckname or 
aVange of decknames specified 
as decknamej.deckname 2 . 

Reverses effect of previous IF 
directive. If encountered when 
no IF is in progress, ELSE is 
diagnosed as an error. 

Terminates effect of previous IF 
directive. If encountered when 
no IF is in progress, ENDIF is 
diagnosed as an error. 
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*IDENT modname 



Specifies 1- to 7-character 
modname to be assigned to 
new modification set. 



*IF atr, name, value 



Conditionally inserts lines which 
follow directive onto compile 
file if condition specified by atr 
(and optionally value) is satis- 
fied. If condition is not satis- 
fied, lines are skipped. Inser- 
tion/skipping effect reverses 
or terminates when ELSE or 
ENDIF directive is encountered. 
Attribute (atr) must be one of: 



DEF 


(name defined) 


UNDEF 


(name not 




defined) 


EQ 


(name equal 




to value) 


NE 


(name not 




equal to 




value) 



*IFCALL name, deckname 



Writes copy of called deck 
onto compile file if 1- to 7- 
character name is defined. 



♦IGNORE deckname 



♦INSERT c 
*I c 
*INWIDTH n 



Causes Modify to ignore subse- 
quent modifications for the 
named deck. Normal process- 
ing of input stream resumes 
with next IDENT, DECK, or 
EDIT directive. 

Identifies lines following as 
insertion lines to be placed 
after specified line. 

Sets width of source text lines 
and insertion text lines (maxi- 
mum is 100); width is preset 
to 72. 



*MODNAME modname 



Identifies modification set 
within deck to be modified. 
Subsequent modification 
directives need to use the 
sequence number only. This 
modname is assumed. 
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*MOVE dname r , dname r dname 2> . . . , dname n 

Enables reordering of decks 
while producing a new program 
library. Decks tome, are 
placed after dname r on the new 
library. 

*NIFCALL name, deckname 

Writes copy of called deck onto 
compile file if 1- to 7- charac- 
ter name is not defined. 

* NOSE Q Sn e on n c°om P Te%VSn°aan 

SEQ is encountered. 

*OPLFILE file,, file 2> .... flle„ 

Declares up to 20 additional 
program library files to be 
logically linked with OPL file 
declared on Modify control 
statement. 

*PREFIX x Identifies prefix character to 

f PREFIX x be used in first column of 

directives other than compile 
file directives; a blank charac- 
ter is illegal. 



*PRFFIXC x Identifies prefix character to 

*PREFIXC x be uge(j . n j irgt ^mnsrf 

directives " '" 

directives 
is illegal. 



t>e useu in in=' ""*"". 
directives for compile file 
directives; a blank character 



*PURDECK dnamej, dname 2< .... dname n 

Purges named decks from new 
program library. 

*PORDECK dname a . dname b 

Purges decks dname a through 
dname b from new program 
library. 

-READ file Reads one directives input 

-READ tue record from specified file. 

*READ file, deckname 

Reads one named record from 
specified file. 
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*READ file,* 



Reads records from specified 
file starting with named record 
until zero-length record or 
end of file. The file must be 
m source file format, that is, 
the first word of the record is 
the record name. 

"READPL deckname Reads deck from program 

library. 



"READPL deckname, ( 



*RESTORE c 



"RESTORE c„ c 



Reads portion of deck starting 
with c, through c„ from pro- 
gram library. i 

Identifies line to be reactivated; 
lines to be inserted optionally 
follow. 

Identifies first and last lines of 
sequence lines to be reactivated- 
lines to be inserted optionally 
follow. 



"RETURN file , file, , . . . , me 



"REWIND fflej, file , 



"SEQ 
"SKIP file, n 

"SKIPR file, rname 
"UNYANK modname 

"UNYANK modname, 



Returns named files to system. 

....file 
n 

Rewinds named files. 

Specifies sequence information 
on compile file. 

Skips forward specified number 
of records on file. If n is 
omitted, one record is skipped. 

Skips forward past the specie 
fied record on file. 



Restores effects of a modifica- 
tion set modname previously 

yanked. 



Restores effects of modifica- 
tion set modname and all 
modification sets from mod- 
name on. 
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*UPDATE 



*WEOF 
*WEOR 



Causes decks to be edited 
according to their sequence on 
the library and causes sequenc- 
ing to continue across decks. 

Writes end of file on compile 
file. 

Writes end of record on com- 
pile file. 



*WIDTH n 



Defines the number of columns 
(maximum of 100) preceding 
the sequencing information on 
the compile file; width is pre- 
set to 72. 



*YANK modname 



Removes effects of a modifica- 
tion set modname. 



*YANK modname,- 



*/ comments 



Removes effects of modname 
and all modification sets incor- 
porated from modname on. 
Yanked sets are denoted by 
parentheses on listing. 

Inserts comments on listing. 
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MODIFY CONTROL STATEMENT 
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MODIFY (p 1 .P 2 P n ) 

p Option 

Option = value 
Option = 

Option Significance 

A Compressed compile file 

Omitted Compile file is not in com- 

pressed format. 

A Compile file is in com- 

pressed format. 

C Compile file output 

Omitted or C Compile output is 

written on file COMPILE. 

C=filename Compile output is written 

on named file. 

C = No compile output. 

CB COMPASS binary output; meaningful with 

Q or X option only 

Omitted or CB COMPASS binary output is 
written on the load-and- 
go file (LGO). 

CB=filename COMPASS binary output is 
written on the named file. 

CB=0 No binary output. 

CG COMPASS get text option; meaningful with 

Q or X option only; takes precedence over 
CS. 

CG Load systems text from 

SYSTEXT. 

CG=filename Load systems text from 
named file. 

Omitted Load systems text from 

overlay named in CS 
option. 

CL COMPASS list output; meaningful with Q 

or X option only. 

CL List output is written on 

OUTPUT file. 

CL=filename List output is written on 
named file. 
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Option 



Significance 



CS 



cv 



Omitted or Short list instead of full 

CL=0 list is generated on OUT- 

PUT file. 

COMPASS systems text; Q or X option 
only. 

Omitted or CS Systems text is on SYS- 
TEXT overlay 



CS=sname 
CS=0 



Systems text name is 
sname. 

No systems text. 



Character conversion; when this option is 
selected, compile file cannot be generated. 

Omitted or No conversion occurs. 

CV=0 



CV=63 



CV=64 



Debug 
Omitted 



Full edit 
Omitted 



64-character set program 
libra'ry is converted to a 
63-character set library. 

63- character set program 
library is converted to a 
64-character set library. 



A directive error aborts 
the job. 

An error does not abort 
the job. 



Decks edited are deter- 
mined by the U parameter 
or by EDIT directives. 



All decks on the library 
are edited and written on 
new program library, 
compile file, and source 
file if the respective 
options are on. 



Directive input 
Omitted or I 
I=filename 

1=0 



Directives are on file INPUT. 

Directives are on named 
file. 

No directive input. 
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Option Significance 



L List output 

Omitted or L List output is written on 
job OUTPUT file. 

L=filename List output, is written on 

the named file. 

L=0 Modify does not generate^ 

a list output file. 

LO List options 

Omitted or LO List options E, C, T, M, 
W, D, and S are selected. 



LO=c. 



Each character in string 
selects an option to a max- 
imum of seven options. 
Characters must not be 
separated. 



Option 


Significance 


A 


List active lines 




in deck. 


C 


List directives 




other than 




INSERT, DELETE 




RESTORE, MOD- 




NAME, I, or D. 


D 


List deck status. 


E 


List errors. 


I 


List inactive 




lines in deck. 


M 


List modifications 




performed. 


S 


Include statistics 




on listing. 


T 


List text input. 


W 


List compile file 



directives. 
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Option 



Significance 



N New program library output 

N 



NR 



N=filename 



Omitted or 
N=0 



New program library is 
written on file NPL. 

New program library is 
written on named file. 

Modify does not generate 
a new program library. 



No rewind of compile file 



Omitted 



NR 



Compile file is rewound 
at beginning and end of 
Modify run. 

Compile file is not rewound 
at the beginning or the end 
of Modify run. 



Program library input 

Omitted or P Program library is on file 
OPL. 



P=filename 



P-0 



Program library is on 
named file. 

No program library input 
file. 



Execute named program 



Omitted or 
Q=0 



Q=program 



Q 



Assembler or compiler is 
not automatically called at 
end of Modify run. 

At beginning of Modify run. 
Modify sets LO=E and sets 
the A parameter. At the 
end of the run. Modify calls 
the assembler or compiler 
named program. 

At the beginning of the 
Modify run, Modify sets 
LO=E and sets the A param- 
eter. At the end of the run, 
Modify calls the COMPASS 
assembler. When this 
option is selected, the CB, 
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Option 



Significance 

CL, CS, and CG param- 
eters are meaningful. In- 
put is assumed to be COM- 
PILE. All other COMPASS 
parameters are set by 
default. 



Source output 



Source output is written on 
file SOURCE. 



S= filename 



Source output is written on 
named file. 



Omitted or 
S=0 

Update edit 

Omitted 



Modify does not generate 
a source output file. 



Decks to be edited are de- 
termined by EDIT directives 
or by the F parameter. 

U Only decks for which the 

directives file contains 
DECK directives are 
edited and written on the 
compile file, new program 
library, and source file. 
However, if F is also 
specified, it takes prece- 
dence. 
Execute named program; directives file 
and list output file are rewound. Same as 
Q option, except Modify directives input 
(I parameter) and list output (L parameter) 
files are rewound before processing. 

Directive on Modify control statement 



Omitted 



Directives input is specified 
by I option. 
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Option Significance 



The Modify control state- 
ment contains the input 
directives following the 
control statement termi- 
nator; the I parameter is 
ignored, if present. This 
eliminates the need for 
using a separate input file 
for the directives when 
only a few directives are 
required. 



| notT] 

Do not place a con- 
trol statement 
terminator after 
the directives. 



60450200 C 2-7« 



FILE FORMATS 



60450200 A 3-1 



PROGRAM LIBRARY FILE 



modification table ■ 



End-of-recordi 



prefix tableg 



modification tableg 



text 2 



End-of-recordp 



prefix 1able3 



End-of-record n 



prefix table n + | 



End-of-record n+ | 
End-of-information 



End -of 


- record n _| 


prefix 


table n 


mod if i cat 


on table n 


text,, 



Deck (record) I 



Deck (record)2 



Decks (records) 



Deck (record) n 
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DECK RECORDS 

PREFIX TABLE FORMAT 



ID Word 


7700 | 


,. 1 









, 


decline me j reserved 


2 




creatio 


dale 






3 




last modific 


at ion date 






| 












I6 9 


ehor set 



Word 


Bits 


Field 


Description 


ID 


59-48 


Table type 


Identifies table as pre 
fix table. 




47-36 


wc 


Word count; length of 
table is 16 g words. 




35-00 


none 


Reserved for future 



16„ 



59-18 deckname 



17-00 none 



59-00 



59-00 



creation 
date 



latest 

modifica- 
tion date 



11-00 char set 



system use. 

Name of deck obtained 
for source deck identi- 
fication line; 1 to 7 
characters. 

Reserved for future 
system use. 

Date that deck was 
created. Format of 
date is: 

A yr/mo/dy. 

Date of most recent 
entry in modification 
table. Format of the 
date is the same as 
for creation date. 

Character set used in 
creation of library. 

0000 63-character set 
0064 o 64-character set 
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TEXT FORMAT 

Each line has the following format. 



59 


53 




35 


17 







°| * c 


*eq. no. 


mhb, 


mM> 2 


m. 




mhb 4 


mhb 5 


: ; : 


compressed tent 



Bits 


Field 


Description 


59 


a 


Activity bit: 

Line is inactive 

1 Line is active 


58-54 


wc 


Number of words of com 
pressed text. 



53-36 seq. no. Sequence number of line 

(octal) according to position 
in deck or modification set. 

35-18 mhbj Modification history byte, 

and ' Modify creates a byte for 

subse- each modification set that 

quent changes the status of the 

18-bit line. Modification history 

bytes bytes continue to a zero byte. 

Since this zero byte could 
be the first byte of a word 
and the compressed line 
image begins a new word, 
the modification history 
portion of the text could 
terminate with a zero word. 

The format of mhb. is: 
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Bits 



Field 



De scription 

a Activate bit: 

Modification 
set deactivated 
the line. 

1 Modification 
set activated 
the line. 

mod. no. Index to the entry 
in the modification 
table. This entry 
contains the name 
of the modifica- 
tion set that 
changed the line 
status. Mod. no. 
of zero indicates 
the deckname. 



MODIFICATION TABLE FORMAT 



Word 
ID 



Bits 
59-48 



Field 



Description 



47-12 none 
11-00 £ 



Table type Identifies table as modi- 
fication table. The 
least significant digit 
indicates whether the 
deck is common or not 
common as follows: 

1 Deck is not 
common 

2 Deck is common 

Reserved for future 
system use 

Number of modification 
names in table 
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Word Bits 
word, 59-18 



16 



Field 



Description 



modname. 1- to 7-character modi- 
fication set name. Each 
modification to a deck 
causes a new entry in 
this table. 

y % YANK flag 

Modifier not 
yanked 

1 Modifier yanked 



DIRECTORY RECORD 



IDENTIFICATION TABLE FORMAT 



I '■ i 



name A Modify-generated directory has the name 
OPL 



DIRECTORY TABLE FORMAT 



random address f / z 
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Word 

ID 



1,3, 
5,... 
I -1 



Bits Field 

59-54 Table type Identifies table as pro- . 
59 54 iao yp ^^ library directory 



17-00 I 



Directory length exclud- 
ing ID word 



59-18 deckname. Name of program library 
aJ L 1 deck, 1 to 7 characters, 

left-justified 



17-00 type t 



Type of record 



6 Old program 
library deck (OPL) 

7 Old program 
library common 
deck (OPLC) 



10 



Old program 
library directory 
(OPLD) 



2,4, 



29-00 



random 
address. 



Address of deck relative 
to beginning of file 
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COMPRESSED COMPILE FILE (A-MODE) 



7700 00 It 



compreuad lint 



compressed ilne n 



Field 



char set 



compressed 
line 



Description 

Character set of record. 

0000 63-character set 
0064 8 64-character set 

A source statement in compressed 
form; that is, three or more con- 
secutive blanks (to a maximum of 
64) are replaced by a byte of the 
form OOxx where xx is one less 
than the number of blanks replaced. 
One or two spaces are unchanged. 
If the source line contains 65 5r 
66 consecutive blanks, they are 
replaced by 007755 or 00775555 
respectively. Sixty seven blanks 
are replaced by 00770002, 68 blanks 
are replaced by 00770003, and so 
on. On a 64-character set program 
library or compressed compile file, 
a 00 character (colon) is repre- 

fn^nm a - 8 a ,° 001 byte - A zer ° Me 
(0000) Signifies the end of line. 
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LIST OUTPUT 
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Depending on list options selected on the Modify 
control statement, list output for Modify contains the 
following: 

• Input directives 

• Status of each deck 

Modifiers are listed first, followed by a list 
of activated lines (or cards), deactivated lines, 
active lines, and inactive lines as they are 
encountered. To the left of. each line are two 
flags, a status flag and an activity flag. The 
status flag can be I (inactive) or A (active). 
The activity flag can be D (deleted) or A (acti- 
vated). Following these lines are the pro- 
cessed modifications and errors, if any. The 
last line contains a count of active lines, in- 
active lines, and inserted lines. 

• Statistics 

This includes lists of: 

Decks on program library. 

Common decks on program library. 

Decks added by initialization directives. 

Decks on new program library. 

Decks written on compile file. 
Completing the statistics is a line containing 
counts of the number of lines on the compile 
file and the amount of storage used during the 
Modify run. 

• Errors 

Modify prints the line in error above the 
diagnostic message. 
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MESSAGES 
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Message 



Explanation 



CARD NOT REACHED. 



COLUMN OUT OF 
RANGE. 



COPY FILE EMPTY. 



CREATION FILE 
EMPTY. 



CV OPTION INVALID. 
DIRECTIVE ERRORS. 



DUPLICATE MODIFIER 
NAME. 



ERROR IN ARGUMENTS. 



ERROR IN DIRECTORY. 



ERROR IN MODIFY 
ARGUMENTS. 



FILE NAME CONFLICT. 



FIRST CARD IS AFTER 
SECOND CARD. 



FORMAT ERROR IN 
DIRECTIVE. 



ILLEGAL DIRECTIVE. 



Sequence number exceeds 
deck range. 

Requested width exceeds 
maximum allowed (100). 

No information on program 
library being copied. 

No source decks on file 
being used for creation. 

CV option other than 63 or 
64. 

Dayfile message indicating 
that one or more input 
directives were in error. 
Fatal error. 

Modifier on IDENT has 
been used previously for 
the deck. 

An invalid parameter has 
been encountered on the 
OPLEDIT control 
statement. 

The program library con- 
tains an error. Fatal 
error. 

Illegal parameter on 
Modify control statement. 
Fatal error. 

The same file cannot be 
used for both applications 
without conflict. Fatal 
error. 

Parameters are erroneous 
or lines are out of order. 

A format error has been 
detected in a directive. 

Directive is out of sequence. 
For example, the CREATE 
directive is after a modifi- 
cation directive for Modify. 
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Message 



Explanation 



ILLEGAL NUMERIC 
FIELD. 



Invalid parameter on 
Modify or OPLEDIT con- 
trol statement. 



INITIALIZATION DIREC- 
TIVE OUT OF ORDER. 



A noninitialization direc- 
tive was encountered be- 
fore the initialization 
directive. 



INVALID ATTRIBUTE. 



INVALID CS ON INPUT. 



-LO-ERROR, MUST BE 
ECTMWDSIA- 

MEMORY OVERFLOW. 



Attribute specified on IF 
directive is other than 
EQ, NE, DEF, or UNDEF. 

The input data uses the 64- 
character set, but the PL 
uses the 63 -character set. 

Illegal list option requested. 
Fatal error. 

Insufficient field length has 
been specified for OPLEDIT 
to execute. 



MIXED CHARACTER 
SET OPL. 



MODIFICATION/ 
DIRECTIVE ERRORS. 



MODIFICATION 

ERRORS. 



OPLEDIT detected decks on 
the program library that 
are in different character 
sets (for example, 63 and 
64). 

Modification and/or direc- 
tive errors are encountered 
when debug mode is selectee 

Modify has detected errors 
during the modification 
phase; fatal if D option is 
not selected. 



MOD(S) TO MOD 
BEFORE THIS IDENT 
CARD. 



A modification directive or 
a different IDENT direc- 
tive refer to the current 
modname. 



NAMES SEPARATED 
BY *.* IN WRONG 
ORDER. 

NO DIRECTIVES. 



Requested decks not in 
correct sequence. 



Directives file empty. 
Fatal error. 
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Message 
NO *IF IN PROGRESS. 



OPERATION ILLEGAL 
FROM ALTERNATE 
INPUT. 

OPLEDIT COMPLETE. 



OPLEDIT ERRORS. 



OVERLAPPING 
MODIFICATION. 



PL ERROR IN DECK 
deckname. 



PROGRAM LIBRARY 
EMPTY. 



RECORD NOT FOUND. 



RECURSIVE *IF, S 
ILLEGAL. 



REDUNDANT CONVER- 
SION IGNORED. 



RESERVED FILE NAME. 



S OPTION ILLEGAL 
WITH A, X, OR Q. 



Explanation 

An ELSE or ENDIF direc- 
tive was encountered with- 
out a previous IF directive. 

File manipulation attempted 
from other than original 
directives file. 

Informative message in- 
dicating that OPLEDIT has 
completed processing. 

Errors were encountered 
during OPLEDIT execution. 

Line modified more than 
once. 

An error was detected in 
the program library for- 
mat during processing of 
deck named. Fatal error. 

No information on file 
specified as program li- 
brary. Fatal error. 

Modify was unable to lo- 
cate requested record on 
file specified. 

An IF directive was en- 
countered while a previous 
IF range was still active 
(no ELSE or ENDIF en- 
countered). Fatal error. 

An attempt was made to 
convert the program li- 
brary file to a like char- 
acter set (63 to 63 or 64 to 
64). Conversion option set 
to zero. 

Operation attempted on a 
file name reserved by this 
utility. 

Source option not legal 
when A, X, or Q option is 
selected. Fatal error. 
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Message 
TOO MANY OPL FILES. 

UNKNOWN DECK. 

UNKNOWN MODIFIER. 

VALUE ERROR. 



X OR Q ILLEGAL 
WITHOUT COMPILE. 



deckname - INVALID 
CS, 63 ASSUMED. 



deekname - MIXED 
CHARACTER SET 
DETECTED. 



Explanation 

More than 50 program li- 
brary files declared. 

Unable to locate requested 
deck on program library. 

Modifier not in modifica- 
tion table for deck. 

Value specified on IF or 
DEFINE directive is greater 
than 177777B. Fatal error. 

Selection of X or Q option 
requires that a compile 
file name be selected. 

The lower byte of word 16B 
of the prefix table for the 
named deck on the program 
library does not contain 
0000 or 0064. 

Upon editing the named 
deck on the program li- 
brary, the character set 
was different from the 
character set of previously 
edited decks. 
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(IRECTIVE FORMAT 

"he format for OPLEDIT directives is identical to 
hat of Modify directives, except that OPLEDIT does 
ot allow the prefix character to be changed (asterisk 
lust be used). 



)PLEDIT DIRECTIVES 



EDITp r P 2 , 



Requests OPLEDIT to edit 
a program library deck and 
transfer it to the new pro- 
gram library. The p. 
specify deck names or 
groups of deck names to 
be edited. 



PULLALL 

or 
PULLALL modname 



PULLMOD modname j 
iodname„, .... mod- 
ame 



PURGE modname 

or 
PURGE modname, * 



Generates a modification 
set that contains the net 
effect of all current modi- 
fication sets (first format) 
or all modification sets 
added after and including 
a specific modification set. 

Reconstructs one or more 
modification sets applied 
to edited decks specified 
by modname.. 

Removes the effects of a 
previous modification set 
or group of modsets sub- 
sequent to and including the 
specified modname. 



>PLEDIT CONTROL STATEMENT 

PLEDIT( Pl ,p 2 ,...,p n ) 



p 


Option 

Option=value 

Option=0 




ption 


Significance 


I 


Directive input 






Omitted or I 


Directives on INPUT 




I=filename 


Directives on named 
file 




1=0 


No directive input 
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Option 



Significance 



Program library input 
Omitted or P 



P=filename 



P = 



Program library is on 
file OPL 

Program library is or 
named file 

No program library 
file 



New program library output 
N 



N=filename 

Omitted or N=0 

List output 
Omitted or L 

L=filename 



New program library i 
written on file NPL 

New program library 
written on named file 

New program library 
not written 



List output is written 
on job OUTPUT file 

List output is written 
on named file 





L=0 


No list output gener- 
ated 


M 


Directive output 






Omitted or M 


Write output from 
*PULLMOD and 
*PULLALL directive! 
on file MODSETS 




M=filename 


Write directive out- 
put on named file 


D 


Debug 


Ignore errors 


F 


Full edit 


Edit all decks 
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Option 


Significance 




LO 


List options 








LO=x 


Set list options x; 
each bit in x, if set, 
turns on correspond 
ing option: 






X 


Description 






001 


Errors. 






002 


Input 
directives. 






010 


Modifications 
made. 






040 


Deck status. 






100 


Directory 
lists. 




Omitted or LO 


Assumes x=153. 


U 


Update edit 








Omitted 


Generate *EDIT 



directives for com- 
mon decks. 

U Generate *EDIT di- 

rectives for all decks. 

U=0 Generate no *EDIT 

directives. 

Directive input 

Omitted Directives specified 

by I parameter. 

Z OPLEDIT control 

statement contains 
input directives fol- 
lowing the control 
statement terminator. 
I parameter is ignored. 



| NOTE | 

Do not place a 
control state- 
ment termi- 
nator after the 
directives. 
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